home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat2 / standard / shm_unlink.z / shm_unlink
Encoding:
Text File  |  2002-10-03  |  5.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. sssshhhhmmmm____uuuunnnnlllliiiinnnnkkkk((((2222))))                                                    sssshhhhmmmm____uuuunnnnlllliiiinnnnkkkk((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_hhhh_mmmm______uuuu_nnnn_llll_iiii_nnnn_kkkk - deletes a shared memory object
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_mmmm_mmmm_aaaa_nnnn_...._hhhh_>>>>
  13.  
  14.      _iiii_nnnn_tttt _ssss_hhhh_mmmm______uuuu_nnnn_llll_iiii_nnnn_kkkk_((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_p_a_t_h_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _p_a_t_h is a pointer to the character string, naming a shared memory object.
  18.      _ssss_hhhh_mmmm______uuuu_nnnn_llll_iiii_nnnn_kkkk deletes the named shared memory object from the file
  19.      namespace. The contents of the shared memory will persist after the call
  20.      to _ssss_hhhh_mmmm______uuuu_nnnn_llll_iiii_nnnn_kkkk, if one or more processes still reference the memory
  21.      object. Once the last reference has been dropped, the space occupied by
  22.      the shared memory object is freed and the object ceases to exist [see
  23.      _cccc_llll_oooo_ssss_eeee(2) and _mmmm_uuuu_nnnn_mmmm_aaaa_pppp(2)].
  24.  
  25.      The named shared memory object is unlinked unless one or more of the
  26.      following are true:
  27.  
  28.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              Search permission is denied for a component of the
  29.                          _p_a_t_h prefix.
  30.  
  31.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              Write permission is denied on the directory
  32.                          containing the shared memory object to be removed and
  33.                          the process does not have the super-user privilege.
  34.  
  35.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              The parent directory has the sticky bit set and the
  36.                          shared memory object is not writable by the user; the
  37.                          user does not own the parent directory and the user
  38.                          does not own the shared memory object.
  39.  
  40.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              Write permission is denied on the shared memory
  41.                          object named by _p_a_t_h.
  42.  
  43.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT              _p_a_t_h points outside the process's allocated address
  44.                          space.
  45.  
  46.      _EEEE_IIII_NNNN_TTTT_RRRR               A signal was caught during the _ssss_hhhh_mmmm______uuuu_nnnn_llll_iiii_nnnn_kkkk system
  47.                          call.
  48.  
  49.      _EEEE_LLLL_OOOO_OOOO_PPPP               Too many symbolic links were encountered in
  50.                          translating _p_a_t_h.
  51.  
  52.      _EEEE_NNNN_AAAA_MMMM_EEEE_TTTT_OOOO_OOOO_LLLL_OOOO_NNNN_GGGG        The length of the _p_a_t_h argument exceeds {_PPPP_AAAA_TTTT_HHHH______MMMM_AAAA_XXXX},
  53.                          or the length of a _p_a_t_h component exceeds {_NNNN_AAAA_MMMM_EEEE______MMMM_AAAA_XXXX}
  54.                          while ______PPPP_OOOO_SSSS_IIII_XXXX______NNNN_OOOO______TTTT_RRRR_UUUU_NNNN_CCCC is in effect.
  55.  
  56.      _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT              The named shared memory object does not exist or is a
  57.                          null pathname.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sssshhhhmmmm____uuuunnnnlllliiiinnnnkkkk((((2222))))                                                    sssshhhhmmmm____uuuunnnnlllliiiinnnnkkkk((((2222))))
  71.  
  72.  
  73.  
  74.      _EEEE_NNNN_OOOO_TTTT_DDDD_IIII_RRRR             A component of the _p_a_t_h prefix is not a directory.
  75.  
  76.      _EEEE_PPPP_EEEE_RRRR_MMMM               The named shared memory object is a directory.
  77.  
  78.      _EEEE_RRRR_OOOO_FFFF_SSSS               The shared memory object to be unlinked is part of a
  79.                          read-only file system.
  80.  
  81. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  82.      _ssss_hhhh_mmmm______oooo_pppp_eeee_nnnn(1), _cccc_llll_oooo_ssss_eeee(2), _mmmm_mmmm_aaaa_pppp(2), _mmmm_uuuu_nnnn_mmmm_aaaa_pppp(2)
  83.  
  84. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  85.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  86.      of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.